이 문서는 Trilium 사용 중 발생하는 문제를 해결하는 기본 절차입니다.

먼저 다시 불러오기

화면 문제는 Ctrl+R로 프런트엔드를 다시 불러오면 해결될 수 있습니다. 계속되거나 백엔드 문제라면 앱 전체를 다시 시작하세요. 데스크톱 앱은 닫았다 다시 열고 Docker는 컨테이너를 재시작합니다.

특정 노트를 열 때 종료되는 경우

잘못된 스크립트가 있는 노트를 시작할 때 다시 열면 오류가 반복될 수 있습니다. TRILIUM_START_NOTE_ID로 처음 열 노트를 지정해 탭을 초기화할 수 있습니다.

TRILIUM_START_NOTE_ID=root ./trilium

시작 스크립트 문제

시작 스크립트나 사용자 위젯 때문에 실행되지 않으면 안전 모드로 시작하세요.

TRILIUM_SAFE_MODE=true ./trilium

배포판에 따라 trilium-safe-mode.bat나 trilium-safe-mode.sh가 제공됩니다. 실행한 뒤 원인이 된 노트를 찾아 수정하거나 제거하세요.

일관성 검사

Trilium은 노트의 상위 연결 등 데이터베이스의 논리 구조를 주기적으로 확인합니다. 오류 알림이 나오면 문제를 보고하고 필요할 경우 익명화한 데이터베이스를 제공하세요.

백업 복원

문제가 심각하다면 백업에서 복원할 수 있습니다.

비밀번호를 잊은 경우

보호된 노트는 비밀번호 없이 복구할 수 없습니다. 아래는 보호하지 않은 노트에 다시 접근하기 위한 원문의 복구 절차입니다. 데이터베이스가 있는 데이터 폴더를 먼저 백업하고 앱을 종료한 뒤 SQLite 편집기로 document.db를 엽니다.

UPDATE options SET value = '77/twC5O00cuQgNC63VK32qOKKYwj21ev3jZDXoytVU=' WHERE name = 'passwordVerificationSalt';
UPDATE options SET value = '710BMasZCAgibzIc07X4P9Q4TeBd4ONnqJOho+pWcBM=' WHERE name = 'passwordDerivedKeySalt';
UPDATE options SET value = 'Eb8af1/T57b89lCRuS97tPEl4CwxsAWAU7YNJ77oY+s=' WHERE name = 'passwordVerificationHash';
UPDATE options SET value = 'QpC8XoiYYeqHPtHKRtbNxfTHsk+pEBqVBODYp0FkPBa22tlBBKBMigdLu5GNX8Uu' WHERE name = 'encryptedDataKey';

변경 사항을 저장하면 로그인 비밀번호가 password로 바뀝니다. 이 절차로 기존 보호 노트가 복구되는 것은 아닙니다. 접근 가능한 노트를 내보내 새 데이터베이스로 옮기거나 기존 DB를 계속 사용한다면 설정에서 즉시 새 비밀번호를 지정하세요.

오류 보고

GitHub 문제 보고에 발생 상황을 적고 오류 로그 안내에 따라 필요한 정보를 함께 제공하세요.